CNV-68980: Must gather image #102013

erpeters157 · 2025-11-07T15:08:43Z

Add information about producing the must-gather image for IBM Fusion SAN troubleshooting.

Version(s):
4.20+

Issue:
CNV-68980

Link to docs preview:
Troubleshooting IBM Fusion Access for SAN

QE review:

QE has approved this change.

Additional information:

openshift-ci-robot · 2025-11-07T15:08:48Z

@erpeters157: This pull request references CNV-68980 which is a valid jira issue.

Warning: The referenced jira issue has an invalid target version for the target branch this PR targets: expected the bug to target the "4.21.0" version, but no target version was set.

In response to this:

Add information about producing the must-gather image for IBM Fusion SAN troubleshooting.

Version(s):
4.20+

Issue:
CNV-68980

Link to docs preview:

QE review:

QE has approved this change.

Additional information:

Instructions for interacting with me using PR comments are available here. If you have questions or suggestions related to my behavior, please file an issue against the openshift-eng/jira-lifecycle-plugin repository.

ocpdocs-previewbot · 2025-11-07T15:21:55Z

🤖 Mon Nov 10 20:09:59 - Prow CI generated the docs preview:

https://102013--ocpdocs-pr.netlify.app/openshift-enterprise/latest/virt/storage/install-configure-fusion-access-san.html

achuzhoy · 2025-11-07T15:56:47Z

modules/virt-troubleshoot-fusion-access-san.adoc

+If you encounter issues with {IBMFusionFirst}, provide the must-gather image with the other information provided to Red Hat support. This image contains critical data about your cluster and project resources, logs, and events from your deployment. The following command is used to create the image:
+
+----
+$ oc adm must-gather --image=icr.io/cpopen/ibm-spectrum-scale-must-gather:v5.2.3.1


v5.2.3.1 is a specific version
Do we want to replace it with something like:
oc adm must-gather --image=icr.io/cpopen/ibm-spectrum-scale-must-gather:v<CNSA version> ?

The CNSA version can be retrieved with:
oc get fusionaccesses.fusion.storage.openshift.io -n ibm-fusion-access fusionaccess-sample -o jsonpath='{.spec.storageScaleVersion}'

@achuzhoy Thank you for the clarification. That is a great suggestion. I will implement the update.

achuzhoy · 2025-11-07T19:12:55Z

/lgtm

openshift-ci-robot · 2025-11-07T19:25:35Z

@erpeters157: This pull request references CNV-68980 which is a valid jira issue.

Warning: The referenced jira issue has an invalid target version for the target branch this PR targets: expected the bug to target the "4.21.0" version, but no target version was set.

In response to this:

Add information about producing the must-gather image for IBM Fusion SAN troubleshooting.

Version(s):
4.20+

Issue:
CNV-68980

Link to docs preview:
Troubleshooting IBM Fusion Access for SAN

QE review:

QE has approved this change.

Additional information:

Instructions for interacting with me using PR comments are available here. If you have questions or suggestions related to my behavior, please file an issue against the openshift-eng/jira-lifecycle-plugin repository.

prabinovRedhat · 2025-11-09T10:50:01Z

/lgtm

openshift-ci-robot · 2025-11-10T13:39:37Z

@erpeters157: This pull request references CNV-68980 which is a valid jira issue.

Warning: The referenced jira issue has an invalid target version for the target branch this PR targets: expected the bug to target the "4.21.0" version, but no target version was set.

In response to this:

Add information about producing the must-gather image for IBM Fusion SAN troubleshooting.

Version(s):
4.20+

Issue:
CNV-68980

Link to docs preview:
Troubleshooting IBM Fusion Access for SAN

QE review:

QE has approved this change.

Additional information:

Instructions for interacting with me using PR comments are available here. If you have questions or suggestions related to my behavior, please file an issue against the openshift-eng/jira-lifecycle-plugin repository.

ousleyp

Just a few comments and suggestions. Please feel free to ping me if you have any questions. Thanks, Erin!

modules/virt-troubleshoot-fusion-access-san.adoc

openshift-ci · 2025-11-10T19:10:24Z

New changes are detected. LGTM label has been removed.

openshift-ci · 2025-11-10T20:10:50Z

@erpeters157: all tests passed!

Full PR test history. Your PR dashboard.

Instructions for interacting with me using PR comments are available here. If you have questions or suggestions related to my behavior, please file an issue against the kubernetes-sigs/prow repository. I understand the commands that are listed here.

abrennan89

Just a few minor changes. Good work! 🙂

abrennan89 · 2025-11-10T20:18:39Z

modules/virt-troubleshoot-fusion-access-san.adoc

+[id="troubleshoot-fusion-access-san_{context}"]
+= Troubleshooting {IBMFusionFirst}
+
+If you encounter issues with {IBMFusionFirst}, provide the must-gather image to Red{nbsp}Hat support. This image contains critical data about your cluster and project resources, logs, and events from your deployment.


Suggested change

If you encounter issues with {IBMFusionFirst}, provide the must-gather image to Red{nbsp}Hat support. This image contains critical data about your cluster and project resources, logs, and events from your deployment.

[role="_abstract"]

If you encounter issues with {IBMFusionFirst}, provide the `must-gather` image to Red{nbsp}Hat support. This image contains critical data about your cluster and project resources, logs, and events from your deployment.

Per the CQA 2.0 guidelines, alll abstracts need this little tag :) ref: https://docs.google.com/spreadsheets/d/1wF_NUWXBJaYsaXp8Dn6TQOx9gD45NCqNxaPkXhYN-zI/edit?gid=503904153#gid=503904153

abrennan89 · 2025-11-10T20:19:02Z

modules/virt-troubleshoot-fusion-access-san.adoc

+
+.Procedure
+
+. To obtain the deployed version of {IBMFusionFirst}, use the following command:


Suggested change

. To obtain the deployed version of {IBMFusionFirst}, use the following command:

. To obtain the deployed version of {IBMFusionFirst}, run the following command:

Use "enter" or "run" per the OCP doc guidelines: https://github.com/openshift/openshift-docs/blob/main/contributing_to_docs/doc_guidelines.adoc#procedure-step-that-introduces-a-command

abrennan89 · 2025-11-10T20:26:00Z

modules/virt-troubleshoot-fusion-access-san.adoc

+This command returns the numeric value of the deployed version of {IBMFusionFirst} such as `2.11.0`.
+====
+
+. To create the must-gather image, use the following command:


Suggested change

. To create the must-gather image, use the following command:

. To create the `must-gather` image, use the following command:

Funny enough, I went to check on this, and you can see in https://docs.redhat.com/en/documentation/openshift_container_platform/4.20/html/support/gathering-cluster-data#gathering-data-specific-features_gathering-cluster-data where it's formatted differently for Virtualization versus regular OCP 🤭

I think it should be formatted as "must-gather image" but we probably need a follow up Jira to fix it in other places in the docs too.

openshift-ci-robot added the jira/valid-reference Indicates that this PR references a valid Jira ticket of any type. label Nov 7, 2025

openshift-ci bot added the size/S Denotes a PR that changes 10-29 lines, ignoring generated files. label Nov 7, 2025

achuzhoy reviewed Nov 7, 2025

View reviewed changes

openshift-ci bot assigned achuzhoy Nov 7, 2025

openshift-ci bot added the lgtm Indicates that a PR is ready to be merged. label Nov 7, 2025

achuzhoy approved these changes Nov 7, 2025

View reviewed changes

openshift-ci bot removed the lgtm Indicates that a PR is ready to be merged. label Nov 7, 2025

openshift-ci bot assigned prabinovRedhat Nov 9, 2025

openshift-ci bot added the lgtm Indicates that a PR is ready to be merged. label Nov 9, 2025

ousleyp reviewed Nov 10, 2025

View reviewed changes

openshift-ci bot removed the lgtm Indicates that a PR is ready to be merged. label Nov 10, 2025

openshift-ci bot added size/M Denotes a PR that changes 30-99 lines, ignoring generated files. and removed size/S Denotes a PR that changes 10-29 lines, ignoring generated files. labels Nov 10, 2025

CNV-68980: Must gather image

b1139c6

erpeters157 force-pushed the CNV-68980 branch from 42574ce to b1139c6 Compare November 10, 2025 19:56

abrennan89 reviewed Nov 10, 2025

View reviewed changes

abrennan89 added CNV Label for all CNV PRs branch/enterprise-4.20 branch/enterprise-4.21 labels Nov 10, 2025

abrennan89 added this to the Continuous Release milestone Nov 10, 2025

	If you encounter issues with {IBMFusionFirst}, provide the must-gather image to Red{nbsp}Hat support. This image contains critical data about your cluster and project resources, logs, and events from your deployment.
	[role="_abstract"]
	If you encounter issues with {IBMFusionFirst}, provide the `must-gather` image to Red{nbsp}Hat support. This image contains critical data about your cluster and project resources, logs, and events from your deployment.


		.Procedure

		. To obtain the deployed version of {IBMFusionFirst}, use the following command:

	. To create the must-gather image, use the following command:
	. To create the `must-gather` image, use the following command:

CNV-68980: Must gather image #102013

Are you sure you want to change the base?

CNV-68980: Must gather image #102013

Conversation

erpeters157 commented Nov 7, 2025 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

openshift-ci-robot commented Nov 7, 2025 • edited by openshift-ci bot Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

ocpdocs-previewbot commented Nov 7, 2025 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

achuzhoy Nov 7, 2025 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Choose a reason for hiding this comment

Uh oh!

erpeters157 Nov 7, 2025

Choose a reason for hiding this comment

Uh oh!

achuzhoy commented Nov 7, 2025

Uh oh!

openshift-ci-robot commented Nov 7, 2025 • edited by openshift-ci bot Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

prabinovRedhat commented Nov 9, 2025

Uh oh!

openshift-ci-robot commented Nov 10, 2025 • edited by openshift-ci bot Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

ousleyp left a comment

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

openshift-ci bot commented Nov 10, 2025

Uh oh!

openshift-ci bot commented Nov 10, 2025

Uh oh!

abrennan89 left a comment

Choose a reason for hiding this comment

Uh oh!

abrennan89 Nov 10, 2025

Choose a reason for hiding this comment

Uh oh!

abrennan89 Nov 10, 2025

Choose a reason for hiding this comment

Uh oh!

abrennan89 Nov 10, 2025

Choose a reason for hiding this comment

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

7 participants

erpeters157 commented Nov 7, 2025 •

edited

Loading

openshift-ci-robot commented Nov 7, 2025 •

edited by openshift-ci bot

Loading

ocpdocs-previewbot commented Nov 7, 2025 •

edited

Loading

achuzhoy Nov 7, 2025 •

edited

Loading

openshift-ci-robot commented Nov 7, 2025 •

edited by openshift-ci bot

Loading

openshift-ci-robot commented Nov 10, 2025 •

edited by openshift-ci bot

Loading